TRS-80 

RS-232-C 

Interface 

Catalog Number 26-1 145 











— "\ 

Radio /hack 

TRS-80 

MICRO 

COMPUTER 

SYSTEM 






^ J 











INTRODUCTION and Discussion of Digital Signals 
INSTALLING and Checkout 
THEORY OF OPERATION 
TERMinal Program and Listing 
DECWRITER Application Program 

Required Equipment: 

TRS-80, Level II with 16K RAM 
Expansion Interface with 
RS-232-C Installed 



CUSTOM MANUFACTURED IN THE USA FOR RADIO SHACK J^ A DIVISION OF TANDY CORPORATION 




12 V +12 V GND 



RS-232-C SCHEMATIC DIAGRAM 



To Our Customers 

What is an Interface? 

It's a generalized means of communication between your TRS-80 and 
some external device, providing the necessary conventions regarding 
data-identification, transmission rates, send-receive sequences, 
error-checking techniques, etc. However, an Interface does not 
provide the programming necessary to use any particular TRS-80/ 
external device system. 

For example, having the Interface installed does not automatically 
enable you to send BASIC programs from one TRS-80 to another; to 
output to a line printer via the Interface; etc. Such applications require 
"driver programs" which must be custom-designed for the equipment 
you intend to use. 

In this manual you'll find listings for two such "driver programs". One 
allows your TRS-80 to function as a terminal, the other allows your 
TRS-80 to output to a popular serial interface line printer, the 
DECWRITER. 

The Radio Shack RS-232-C Interface is designed to meet the EIA 
standards. However, we cannot guarantee that it will work with all 
so-called "RS-232-C compatible" devices. Nor do we commit 
ourselves to provide engineering and programming support for such 
applications, or other special custom-use situations. 

We do, however, guarantee that our Interface will function correctly 
with all our own RS-232-C equipment. 



©Copyright 1978, Radio Shack, A Division of Tandy Corporation, 
Fort Worth, TX. 76102 U.S.A. 



Introduction 



The term RS-232-C refers to a specific EI A (Electronics Industries 
Association) standard which defines a widely accepted method for 
interfacing data terminal equipment with data communications 
equipment. The RS-232-C Interface is by far the most universally 
used standard for interfacing data processing equipment. Most video 
terminals, modems, card readers, line printers, mini-microcomputers, 
etc., utilize the RS-232-C standard for data interchange between 
devices. 

The addition of the RS-232-C to the TRS-80 Expansion Interface 
opens up a whole new world of compatibility. The RS-232-C 
Interface is designed to mount inside the TRS-80 Expansion 
Interface. For example, the external equipment could be a serial 
line printer, a Radio Shack Telephone Interface, or a video terminal, 
etc. The point is this, now you can interface with any equipment 
which is RS-232-C compatible. 

A most useful application program of the RS-232-C Interface will 
permit you to connect your TRS-80 via a Telephone Interface to 
time sharing computer system. This TERM program is supplied 
(on cassette tape) with the RS-232-C Interface. 



Many TRS-80 owners would like to be able to use their serial printers 
with the LPRINT command in LEVEL II BASIC. With the RS-232-C 
Interface installed in the Expansion Interface, you can do that. A 
programming example and listing for this application is provided in 
this Manual. 



Transmission of Digital Data 

The transfer of digital data over relatively long distances is generally 
accomplished by sending data in serial form using a single twisted 
wire pair to connect the transmitting and receiving devices. One of 
two general transmission techniques is commonly used, asynchronous 
or synchronous. The transmission technique used in the Radio Shack 
system is asynchronous-bit-seriai. Since we don't use the synchronous 
technique, we'll not mention it again. Asynchronous transmission 
does not require a synchronizing clock to be transmitted with the 
data and, the characters need not be contiguous. This means that 
gaps of varying lengths may be present between transmission of 
individual characters. 

The bits which comprise a data character (generally from five to eight 
bits in length) and synchronizing start and stop elements are added 
to each character as shown in Figure 1 . The start element is a single 
logic zero (0) data bit that is added to the front of each character. 
The stop element is a logic one (1) that is assed to the end of each 
character. The stop element is maintained until the start element of 
the next character is transmitted. There is no upper limit to the 
length of the stop element. However, there is a lower limit that 
depends on system characteristics. Typical lower limits are 1.0, 1.42 
or 2.0 data-bit intervals (although most modem systems use 1.0 or 
2.0 stop bits). The negative-going transition of the start element 
defines the location of the data bits in the character being 
transmitted. A clock source at the receiver is reset by this 
transition and is used to locate the center of each data bit. 

There are several good reasons for using the asynchronous data 
transmission system. A clock signal does not need to be transmitted 
with the data, thus, equipment is simpler. Also, the characters 
don't need to be sent all at one time; they can be transmitted as 
they become available. This is particularly useful when transmitting 
data from manual-entry input devices (e.g. a keyboard). The major 
disadvantage of asynchronous transmission is that it requires a 
significant portion of the communications bandwidth for start 
and stop elements. 

STOP ELEMENT STOP ELEMENT 

, 1 / 

^T^zzO^— L -^D== = r rL — 

START ELEMENT ONE 8 BIT CHARACTER START ELEMENT ONE 8 BIT CHARACTER 

(11001000) (00100000) 

FIGURE 1. ASYNCHRONOUS DATA 



The rate at which asynchronous data is transmitted is defined as 
the baud rate. Baud rate is the inverse of the time duration of the 
shortest signal element. Normally, this is one data bit interval. 
The baud rate is equal to the bit rate if one stop bit is used; but for 
systems which use more than one stop bit, the baud rate does not 
equal the bit rate. 

Asynchronous transmission over a simple twisted wire pair can be 
accomplished at moderately high baud rates (10K baud or higher, 
depending on the length of wire, type of drivers, etc.). Transmission 
over the telephone network is generally limited to approximately 
2K baud and a modem is required to convert the data pulses to 
tones that can be transmitted through the telephone network. 
Radio Shack's Telephone Interface is the ideal modem for this 
RS-232-C Interface. 



Signal Conventions 

The E.I. A. RS-232-C electrical specification defines voltage levels 
and corresponding logic conventions associated with data and control 
information transmitted between equipment. For data interchange, 
the signal is considered in the marking condition when the voltage 
measured at the interface point is more negative than —3 Volts(with 
respect to signal ground). The signal is considered in the spacing 
condition when the voltage is more positive than +3 Volts(with 
respect to signal ground). The marking condition corresponds 
to a logic one ( 1 ) and the space condition corresponds to a logic 
zero (0). For timing and control interchange circuits, the function 
is considered to be"on"when the voltage on the interchange circuit 
is more positive than +3 Volts(with respect to signal ground); 
and is considered to be"off"when the voltage is more negative than 
—3 Volts(with respect to signal ground). The "on"condition 
corresponds to a logic zero (0) and the"off"condition corresponds 
to a logic one (1). Table 1 summarizes this information. 



NOTATION 


INTERCHANGE VOLTAGE 


Negative 


Positive 


Binary State 
Signal Condition 
Function 


1 

Marking 

OFF 




Spacing 

ON 



TABLE 1. ON/OFF CONDITION 



Pin Designations and Signal Descriptions 

The mechanical specification of the RS-232-C requires a 25-pin 
connector (called a DB-25). Table 2 specifies the pin assignments 
and signal descriptions as they apply to the Radio Shack RS-232-C 
Interface. 



Pin Number 


Abbreviation 


Description 


1 


PGND 


Protective Ground 


2 


TD 


Transmit Data 


3 


RD 


Receive Data 


4 


RTS 


Request-to-Send 


5 


CTS 


Clear-to-Send 


6 


DSR 


Data Set Ready 


7 


SGND 


Signal Ground 


8 


CD 


Carrier Detect 


20 


DTR 


Data Terminal Ready 


22 


Rl 


| Ring Indicator 



TABLE 2. PEN DESIGNATIONS AND SIGNAL DESCRIPTION 

Protective Ground: This must be bonded to the chassis or equipment 
frame. It may also be connected to Signal Ground. 

Transmit Data: Direction-to data communication equipment. Signals 
on this circuit are generated by the data terminal equipment for 
transmission of data to remote equipment. This signal should be 
held in the marking condition during intervals between characters 
and at all times when no data is being transmitted. 

Received Data: Direction-from data communication equipment. 
Signals on this circuit are received from remote equipment which 
transmits data to the terminal. This signal should be held in the 
marking condition during intervals between characters and at all 
times when no data is being received. 



Request-to-send: Direction-to data communication equipment. 
This signal is required by the terminal equipment to control the 
direction of data transmission by the data communication equipment. 
On one-way or duplex channels, the "on" condition maintains the 
data communication equipment in the transmit mode. The "off" 
condition maintains the data communication equipment in the 
non-transmit mode. 

On a half duplex channel, the "on" condition maintains the data 
communication equipment in the transmit mode and inhibits the 
receive mode. The "off" condition maintains the data communication 
equipment in the receive mode. 



Clear-to-Send: Direction-from data communication equipment. This 
signal is generated by the data communication equipment and 
indicates whether or not the data set (modem) is ready to transmit 
data. The "on" condition is an indication to the data terminal 
equipment that the data set can accept data on the Transmit Data 
circuit. The "off condition is an indication to the data terminal 
equipment that it should not transfer data to the data set. 

Data Set Ready: Direction-from data communication equipment. 
This signal indicates the status of the local data set to the data 
terminal equipment. The "on" condition of this circuit indicates 
that the data communication equipment is not in test, talk or dial 
mode and has completed any timing functions required to complete 
call establishment (answer tone, etc.). The "off condition will 
appear at all other times and indicates that the data terminal should 
accept only Ring Indicator signals and ignore all other signals 
(appearing on any other interchange circuit). 

Data Terminal Ready: Direction-to data communication equipment. 
This signal is used to control the switching of the data communi- 
cation equipment to the communications channel. The "on" 
condition indicates to data communication equipment that it 
should connect to the communications channel and that it should 
maintain the connection as long as the "on" condition is present. 
The "off condition causes the data communication equipment 
to be removed from the communications channel following any 
in-process transmission of data. 

Ring Indicator: Direction-from communication equipment. The 
"on" condition of the circuit indicates that a ringing signal is being 
received on the communications channel. In general, this means 
that the data set is being polled and that data communication is 
desired by the polling device. The "off condition is held during 
the off segment of the ringing cycle (between actual rings) and at all 
other times when ringing is not being received. 

Carrier Detect (Receive Line Signal Detector): Direction-from data 
communication equipment. When "on", this signal indicates that 
the data set is receiving a carrier from a remote data set via the 
communications channel. The "off condition indicates that no 
carrier is being received or that the signal quality is unsuitable for 
data demodulation. 



Installing The RS-232-C 

Note: Some of the first TRS-80 Expansion Interface units were 
manufactured with a 42-pin connector (required lor the 
RS-232-C Interface). If your Expansion Inierface does not 
incorporate this connector, you must return it for proper 
installation of this connector and Hie RS-232-C. Any at tempi 
to install this connector on your own will aulomalically void 
all warranly. 

If your Expansion Interface incorporates the necessary 42-pin con- 
nector, install the RS-232-C Interface as follows: 

1 . Position the TRS-80 Expansion Interface as shown in Figure 2 and 
remove the Expansion Door. 

2. Remove two machine screws and washers from the 42-pin con- 
nector. 

3. Position the RS-232-C Interface as shown. Line up the 42-pin 
connector mounting holes with the screw holds in the RS-232-C 
Interface Printed Circuit Board. Fasten with two washers and 
screws. 

4. Position the RS-232-C as shown below (front view). Remove cover 
from the center of the Expansion Interface. Carefully press the 
40-pin connector of the cable supplied with the RS-232-C over the 
edge connector which will be exposed; the flat cable must extend 
downward. Connect the other end of the cable (DB-25) to the 
desired Modem or Line Printer, etc. 




EXPANSION BOARD 
PORT CARD EDGE-J1 



EXPANSION INTERFACE 

FRONT VIEW OF EXPANSION INTERFACE 



EXPANSION DOOR 



MACHINE SCREWS * 



WASHER 




VIEW OF FLOOR 
WITH 42 CONTACT 
CONNECTOR INSTALLED 



TRS-80 EXPANSION INTERFACE 



FIGURE 2. RS-232-C INSTALLATION 



Checkout 

1 . Set the RS-232-C Sense Switches (listed in Table 3 on Page 13) for 
the desired Baud Rate, Parity, etc., as shown in the following 
example; 



Switch 


S8 


S7 


S6 


S5 


S4 


S3 


S2 


SI 


Baud Rate = 300 


CLOSED 


CLOSED 


OPEN 












One stop bit and 
parity enabled 








CLOSED 


CLOSED 








Word length = 7 bits 
of data plus one 
parity bit 












CLOSED 


OPEN 




Even parity 
















OPEN 



Also, set TERM/COMM Switch to TERM (assuming you are 
connecting to a Modem). 

2. Load the cassette tape via the Level 11 BASIC "System" command 
using "TERM" as the label. Type a slash symbol (/) and press 
13^13;! to activate the program (which is located at 5000-Hex). 

3. Correct activation of the TERM tape will be indicated by a clear- 
ing of the Video Display Screen; the cursor will be at the upper 
left corner of the Video Display screen. 

Note: If you connect together pins 2 and 3 of the 25-pin connector 
tCDB-25) on the RS-232-C cable] , the keyboard output will be 
"echoed" back to the Video Display Screen, indicating correct 
operation of the Interface and TERM program. 

4. Replace the Expansion Door. 



COMM/TERM SWITCH 
TERM 



COMM 



W^?H?^^3!WW? 



RS-232-C INTERFACE BOARD 
\ 






DIP SWITCHES S1-S8 



IH§1 




FIGURE 3. RS-232-C SWITCHES 



Theory of Operation 

The Radio Shack RS-232 Interface is a versatile programmable 
interface which will permit you to interface with almost any 
equipment which is RS-232-C compatible. There are essentially two 
different categories of RS-232-C equipment, namely data terminal 
equipment and data-comm (data communications) equipment. 
The Radio Shack RS-232-C Interface is configured from the data 
terminal's point of view, for interfacing with data-comm equipment. 

You can control the configuration of the Interface two ways, by 
sense switch selection or by direct selection using software control. 

Universal Asynchronous Receiver-Transmitter 

Figure 4 is a block diagram of the RS-232-C Interface. The heart of. 
the Interface is the UART (Universal Asynchronous Receiver- 
Transmitter). This MOS LSI device (TR1602A) contains most of the 
hardware needed to receive and transmit serial data. The UART is an 
industry standard, general purpose, programmable device for 
interfacing an asynchronous serial data channel to the parallel data 
structure of a microprocessor. The transmitter section of the 
UART converts parallel data from the microprocessor into a 
serial word which contains the data along with start, parity and 
stop bits. The receiver section converts a serial word (with start, 
data, parity and stop bits) into parallel data, and verifies proper data 
transmission by checking parity and receipt of a valid stop bit. 

The operation of the UART can be programmed as follows: 
The word length can be 5, 6, 7 or 8 bits; parity generation and 
checking can be inhibited, the parity may be even or odd and 
the number of stop bits may be either one or two, with 
one-and-one-half when transmitting a 5-bit code. 

The UART contains several internal registers which will permit you 
to configure the serial data channel, monitor the UART status, load 
data to be transmitted, and read data that is received on the serial 
data channel. Later we will discuss the UART registers in more 
detail. 
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FIGURE 4. RS-232-C BLOCK DIAGRAM 



11 



Baud Rate Generator 

Directly above the UART in Figure 4 is a block labeled BRG (Baud 
Rate Generator). This section of the interface outputs two clock 
signals essential to the proper operation of the UART. The two 
clock signals (TRANSMIT FREQ & RECEIVE FREQ) determine the 
transmit and receive baud rates of the serial channel. A 5.0688 MHz 
crystal is used as a timing reference for the BRG. The BRG can be 
programmed to divide this reference frequency down to the frequen- 
cies needed by the UART. For both transmit and receive operations, 
the UART requires a clock at 16 times the baud rate desired. The 
BRG transmit and receive frequency outputs can be independently 
programmed by loading the appropriate constants into its internal 
registers. This feature of the BRG makes it possible to transmit and 
receive data at different baud rates. 

Sense Switches 

Directly below the UART in Figure 4 is a block labeled SENSE 
SWITCHES. This section is made up of eight single-pole single-throw 
switches (S1-S8) which you use to select the baud rate, bits per 
word, parity (odd or even), stop bits (one, one-and-one-half, or 
two), and enable or disable parity generation. If you want, you can 
ignore these switches and under software control, directly configure 
the Interface for non-standard baud rates, different receive and 
transmit frequencies, etc. Table 3 summarizes the operation of the 
sense switches. 



Handshake Latch 

The Radio Shack RS-232-C Interface can control (with proper soft- 
ware) the logic state of two of the control signals on the Interface 
(Request-To-Send and Data Terminal Ready). This is accomplished 
by loading the Handshake Latch with the appropriate bit pattern. 
Four of the interface signals can be sensed by the CPU (Clear-To- 
Send. Data Set Ready, Carrier Detect, and Ring Indicator) by 
reading the Modem Status Register, shown in Figure 4. The 
Handshake Latch and Modem Status Register, with the appropriate 
software, allows a handshake dialog to occur between the CPU 
and the equipment connected to the RS-232-C Interface. 
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BAUD RATE 


S6 


S7 


S8 


110 


Closed 


Closed 


Closed 


150 


Closed 


Closed 


Open 


300 


Open 


Closed 


Closed 


600 


Open 


Closed 


Open 


1200 


Closed 


Open 


Closed 


2400 


Closed 


Open 


Open 


4800 


Open 


Open 


Closed 


9600 


Open 


Open 


Open 



PARITY ENABLE 


S4 


STOP BITS 


S5 


Parity Enable 
Parity Disabled 


Closed 
Open 


One Stop Bit 
Two Stop Bits 


Closed 
Open 



WORD LENGTH 


S2 


S3 


(Excluding 






parity bit) 






5 Bit Word 


Closed 


Closed 


6 Bit Word 


Closed 


Open 


7 Bit Word 


Open 


Closed 


8 Bit Word 


Open 


Open 



PARITY SELECT 

Odd Parity 
Even Parity 


SI 

Closed 
Open 



TABLE 3. OPERATION OF SENSE SWITCHES 



Logic Conventions 



The logic internal to the RS-232-C operates with TTL logic levels 
(3.5V or more = Logic 1 , and 0.8V or less = Logic 0). The logic 
convention used for interfacing two RS-232-C devices is El A levels 
(— 3V or less = Logic one, +3V or more = Logic 0). The logic 
levels must therefore be converted from one convention to the other 
when interfacing two devices. The blocks in Figure 4 labeled 
EIA To TTL and TTL To E1A provide this level conversion. 
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Port Addresses 

The Radio Shack RS-232-C Interface is an 1/O-mapped device which 
uses four port addresses (E8H. E9H. EAH and EBH) for communica- 
tion with the CPU. I/O-mapped devices in a Z-80 system use the 
lower address bits (A0-A7) in conjunction with the IN* and OUT* 
signals to address the desired ports. Figure 5 shows the timing 
associated with this addressing scheme. 



SYSTEM CLOCK 


A0-A7 


IN* 


DATA BUS 


OUT* 


DATA BUS 



T2 I TW 




PORTADRESS 



OUT 



J- 



-GHh 



1.8 Mhz 



READ CYCLE 



WRITE CYCLE 



FIGURE 5. I/O TIMING DIAGRAM 



Decode Logic 



The block labeled DECODE LOGIC in Figure 4 provides eight 
low-going strobes that are used by the RS-232-C. These strobes 
allow the CPU to select any of the registers and latches in the 
RS-232-C Interface for an input or output operation. Table 4 
summarizes the I/O port address allocation as implemented in the 
RS-232-C Interface and the function performed. 



ADDRESS 


OUT (I/O PORT WRITE) 


IN (I/O PORT READ) 


E8H 


Master Reset (Any Data) 


Modem Status Register 


E9H 


Baud Rate Select 


Configuration Sense 
Switches 


EAH 


UART Control Register 
and Handshake Latch 


UART Status Register 


EBH 


Transmit Data Register 


Received Data Register 



TABLE 4. I/O MAPPED MEMORY ALLOCATION 
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Each of the above registers performs a specific function related to 
the RS-232-C Interface. An output to the Master Reset Port (E8H) 
resets the UART into a known state. This operation should be 
performed once before attempting to load or read any of the 
UART's registers. This operation is performed by executing the 
following Z80 instruction: 

OUT (0E8H), A ; OUTPUT TO MASTER RESET LOCATION 

The contents of A are not important and do not relate in any way to 
the result of the operation. An input operation from this port 
address (E8H) causes the contents of the Modem Status Register 
to be loaded into a register of the CPU. This is accomplished by 
executing the following Z80 instruction: 

IN A, (0E8H) ; READ MODEM STATUS REGISTER 

Execution of this instruction loads the contents of the Modem 
Status Register into A. The information now in A represents 
information relevant to the status of external equipment connected 
to the Interface. 

Any output operation to Port E9H loads the Baud Rate Generator 
with a constant which determines the receive and transmit baud 
rates of the serial channel. This is accomplished by executing the 
following Z80 instructions: 

LD A, 22H ; LOAD CONSTANT IN A 

OUT (0E9H), H ; LOAD BRG WITH CONSTANT 

Execution of this sequence results in the serial channel being con- 
figured to transmit and receive data at 1 10 baud. Table 5 
summarizes the relationship between the constants loaded into the 
BRG and the resultant baud rates selected. The high-order nibble 
(D7-D4) loaded into the BRG determines the transmit baud rate, 
while the low-order nibble (D3-D0) determines the receive baud rate 
of the serial channel. 
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Summary of BRG Programming 

Radio Shack software supports the baud rates which have a yes in 
the Switch Selectable column of Table 5. You can program 
non-standard baud rates by loading the BRG with the appropriate 
constants. An input operation from port E9H loads a register in the 
CPU with the bit pattern programmed by the Configuration Sense 
Switches. As we noted before, the Sense Switch Block in Figure 4 
consists of eight single-pole single-throw switches. When a switch 
is open, it pulls up (+5V) the input of an octal tri-state buffer; 
when a switch is closed, it pulls an input low. 



NIBBLE 


TRANSMIT OR 






SWITCH 


LOADED 


RECEIVE BAUD RATE 


lOx CLOCK FREQ. 


% ERROR 


SELECTABLE ? 


OH 


50 


0.8 kHz 





No 


1H 


75 


1.2 kHz 





No 


2H 


110 


1.76 kHz 





Yes 


3H 


134.5 


2.1523 kHz 


0.016 


No 


4H 


150 


2.4 kHz 





Yes 


5H 


130 


4.8 kHz 





Yes 


6H 


600 


9.6 kHz 





Yes 


7H 


1200 


19.2 kHz 





Yes 


8H 


1800 


28.8 kHz 





No 


9H 


2000 


32.081 kHz 


0.253 


No 


AH 


2400 


38.4 kHz 





Yes 


BH 


3600 


57.6 kHz 





No. 


CH 


4800 


76.8 kHz 





Yes 


DH 


7200 


115.2 kHz 





No 


EH 


9600 


113.6 kHz 





Yes 


FH 


19,200 


316.8 kHz 


3.125 


No 



TABLE 5. SUMMARY OF BRG PROGRAMMING 

The decode logic, in response to an input operation from port E9H, 
provides a low-going strobe which is connected to the enable input 
of the tri-state buffer. This strobe, when low, allows the buffer to 
present the logic state of its inputs to the data bus for loading 
into the CPU. This operation is performed by executing the 
following instructions: 

IN A, (0E9H) ; LOAD SWITCH SELECTIONS 

After execution of this instruction, the A register on the CPU will 
contain the bit pattern which corresponds to the switch settings. 
This information must now be interpreted by the software and the 
proper sequence of commands issued by the CPU to configure 
the Interface. 
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An output to the Port Address EAH loads the UART Control 
Register and Handshake Latch. These two functions are separate 
and distinct, with each using different bits of the register for 
control. The upper five bits (D7 - D3) of this Port Address 
determine the word length, stop bits, and parity convention of 
the serial channel. The lower three bits (D2 - DO) are latched 
control outputs, one of which disables Transmit Data when low, 
and the remaining two control Data Terminal Ready and 
Request-To-Send. A certain degree of caution should be used 
when outputting to this Port Address to avoid an unwanted 
interaction. Table 6 summarizes the registers and bit allocations 
of each for the RS-232-C Interface. 



DATA 
BIT 


MODEM STATUS 
REGISTER 


CONFIGURATION 
SENSE SWITCHES 


UART CONTROL 

REGISTER AND 

HANDSHAKE LATCH 


UART STATUS 
REGISTER 


D7 


Clear to send 
Pin 5 DB-25 


Even Parity Enable 
1 = even, = odd 


Even Parity Enable 
1 = even, = odd 


Data Received 
1 = Condition true 


D6 


Data Set Ready 
Pin 6 DB-25 


Word length Select 1 


Word length Select 1 


Transmitter Holding Register 
Empty 1 = Condition true 


D5 


Carrier Detect 
Pin 8 DB-25 


Word length Select 2 


Word length Select 2 


Overrun Error 
1 = Condition true 


D4 


Ring Indicator 
Pin 22 DB-25 


Stop Bit Select 
1 = 2 bits, = 1 bit 


Stop Bit Select 
1 = 2 bits, = 1 bit 


Framing Error 
1 = Condition true 


D3 


Unused 


Parity Inhibit 
1 disables parity 


Parity Inhibit 
1 disables parity 


Parity Error 

1 = Condition true 


D2 


Unused 


Baud Rate 3 


Break 

Disables Transmit data 


Unused 


Dl 


Receiver Input UART P20 


Baud Rate 1 


Request to send 
Pin 4 DB-25 


Unused 


DO 


Unused 


Baud Rate 2 


Data Terminal Ready 
Pin 20 DB-25 


Unused 




IN 0E8H 


IN 0E9H 


OUT 0EAH 


IN 0EAH 



TABLE 6. BIT ALLOCATIONS FOR REGISTERS AND LATCHES 
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Hi 



The following example, in Z80 assembly language, shows how to 
read the Sense Switches. Combine this with the latch bits desired, 
load the UART Control Register and Handshake Latch, and save the 
current state of these control bits for later updates if necessary. 

IN A, (0E9H) ; READ SENSE SWITCHES 

AND 0F8H ; ZERC LOWER 3 BITS 

OR 05H ; SETS REQUEST TO SEND, RESET DATA 

TERM READY, AND SETS BREAK 
OUT (0EAH) ; LOADS UART CONTROL REGISTER & 

HANDSHAKE LATCH 
LD (IMAGE), A ; SAVES BIT PATTERN FOR UPDATES 

The label IMAGE in the last line above refers to memory location 
which is used to save the current state of the UART Control Register 
and the Handshake Latch. Suppose you want to change the logic state 
of Request-tc-Send. The following example shows how to do this 
without changing the UART Control Register or the other Handshake 
bits. 

LD A, (IMAGE! ; LOAD CURRENT STATE OF UART 

CONTROL REGISTER AND HANDSHAKE 
LATCH 

RES 0,A ; RESETS BIT ZERO IN A (REQUEST 

TO SEND) 

OUT (0EAH),A ; LOADS NEW BIT PATTERN 

LD (IMAGE), A :SAVE NEW PATTERN FOR UPDATES 

An input operation to Port Address EAH reads the UART Status 
Register. Bits D7-D3 convey information about the current status 
of the UART (Receive Data ready for input, Transmitter Holding 
Register empty, overrun error, framing error, and parity error). 
The remaining bits D2-D0 are unused. You can read this register by 
executing the following Assembly Language instruction. 

IN A, (0EAH) ; READ UART STATUS REGISTER 

Execution of this instruction loads the "A" register with the contents 
of the UART Status Registers. Additional software instructions can 
interpret this status information and determine if a new character can 
be loaded for transmission, if a new character has been received or 
if received errors have occurred. 

An output operation to Port Address EBH loads the UART Trans- 
mitter Holding Register with a new character to be transmitted by 
the UART. You should not do this until the holding register is found 
to be empty (meaning that the previous character has been transferred 
to the transmitter register for transmission). Do this by reading the 
UART Status Register and checking the proper bit for a logic one 
(1). The following Assembly Language instructions illustrate how 
this is done. 
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; OUTPUT CHARACTER TO UART 

FOR TRANSMISSION 
; A SHOULD CONTAIN CHARACTER 
TO BE TRANSMITTED 
PUSH A ; SAVE CHARACTER TO BE 

TRANSMITTED 
STATIN IN A, (0EAH) ; LOAD UART STATUS REGISTER 

BIT 6#A ; TEST TRANSMITTER HOLDING 

REGISTER FOR A HIGH 
JR Z, STATIN ; TR Y A G Al N I F NOT 
POPAF ; RESTORE CHARACTER TO BE 

TRANSMITTED 
OUT (0EBH),A ; LOAD HOLDING REGISTER 
WITH CHARACTER 

An input operation from Port Address EBH reads the UART 
Receiver Holding Register and resets the Received Data bit in the 
UART Status Register. You should not do this until the Received 
Data bit is set in the UART Status Register (meaning that a com- 
plete character has been received and transferred to the Receiver 
Holding Register). The following sequence of Assembly Language 
instructions illustrate how this is done. 

; INPUT A CHARACTER FROM 

THE UART 
; CHARACTER RECEIVED WILL BE 
IN A 
INCHAR IN A, (0EAH) ; LO A D U ART ST ATUS 

BIT 7, A ; TEST DATA RECEIVED FOR HIGH 

JR Z , INCHAR ; TRY AGAIN IF NOT 

IN A, (0EBH) ; LOAD RECEIVED CHARACTER 

Execution of this sequence will load the character received into 
register A and the UART Control Register Received Data bit will 
be reset. 

Earlier we told you that there are two categories of RS-232-C 
equipment, data terminal equipment and data communications. The 
two categories differ in which pins on the DB-25 connector are used 
for the Transmit Data and Receive Data functions. Data terminal 
equipment transmits data on pin 2 and receives data on pin 3. 
Equipment which interfaces to data terminal equipment must 
therefore receive data on pin 2 and transmit data on pin 3 (refer to 
Table 2). This means that it is sometimes necessary to reverse the 
operation of these two signals, depending on the specific interface 
requirements. A double-pole double-throw switch is provided in 
the Radio Shack RS-232-C Interface for this purpose (refer to 
Schematic Diagram). One position is labeled TERM (data terminal) 
and other COMM (communications equipment). 
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The RS-232-C Interface requires four power supply voltages (+5, —5, 
+ 1 2V and —1 2V). The Expansion Interface provides the +5V supply 
from which the other voltages are derived by using a DC-to-DC 
converter. The DC-to-DC converter used in the Radio Shack 
RS-232-C Interface inputs +5V and outputs +12V and -12V. 
A simple resistive voltage divider is used with the —1 2V to 
produce the — 5V supply (refer to Schematic Diagram). DC-to-DC 
converters are inherently noisy and must be properly decoupled 
from the input supply and the outputs must be properly filtered. 
LI , L2, CI , CIO, CI 1, C3 and C9 perform this decoupling and 
filtering function. 



Terminal Program 

The Following Hardware is Required: 

* TRS-80 LEVEL II with 16K RAM 

.* Expansion Interface with RS-232-C installed. 

The "TERM"inal program will cause the TRS-80/RS-232-C to 
function as a full duplex terminal which displays ASCII encoded 
text inputted from the RS-232-C port, and which outputs keyboard 
input to the RS-232-C port. (A complete listing of the TERM program 
is provided later on in this Manual.) 

RS-232-C Input to Display 

Activation of program clears the screen and the cursor will be 
positioned at the upper left. As text is input, it is displayed and 
the cursor increments to the right. Line overflow goes onto the next 
line (is not truncated). As the screen is filled, incoming text causes 
it to roll-up (scroll) with the new text directed to the bottom of the 
screen. 

Back space (hex 08) and return (hex 0D) are recognized and 
executed by the display program. Other ASCII control codes are 
ignored. Delay periods are required (null [hex 00] ) after return at 
high baud rates (1200, 2400, etc.) to allow the display to scroll 
as indicated in Table 7. 
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BAUD Rate 


#Nulls 


110 


None 


150 


None 


300 


None 


600 


None 


1200 


2 


2400 


4 


4800 


8 


9600 


16 



TABLE 7. NULLS REQUIRED AFTER return 



Lower case ASCII will be converted to upper case for display (the 
TRS-80 cannot display lower case without hardware modification 
[not supported by Radio Shack]). 

Keyboard Output to RS-232-C 

The keyboard is continually scanned for new key input signals. New 
key strobes are converted to ASCII and outputted to the RS-232-C 
Interface for transmission. 

A keyboard entry will not cause an input to the display unless the 
RS-232-C output is echoed back to the input section of the 
RS-232-C port. This is called full duplex or FDX. 

If you short together pins 2 and 3 on the RS-232-C connector, the 
terminal can act in a "local" mode and keyboard action will directly 
display on the CRT. Notice also that such keyboard activity is not 
stored in memory for later transmission, as is sometimes an option 
with certain expensive CRT terminals. 

The Radio Shack Telephone Modem has a switch that can be set to 
"half duplex" (or HDX) to allow communication over a 
telephone line and provide (within the modem coupler) the echo 
function which allows the TERM program to be used in HDX 
situations. Most other low speed (300 Baud) modems will also 
allow this. 

Special provision has been made to allow four 7-bit codes (selected 
by the user) to be output from the keyboard. Refer to Table 8. 
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Keys pressed 


Code at Address 


Default Code 


shifH , A 
shift J , B 
shift! ,C 
shift! , D 


50B9H 

50 BAH 
50BBH 
50BCH 


03H = EOT 
1BH = ESC 
FCH= 1 
FFH = DEL 



TABLE 8. KEYBOARD OUTPUT CODES 

To generate any of these codes it is necessary to: 

(1) hold down the 'shift' key, 

(2) hold down the " I " key.. 

(3) press A, B, C or D. 
The keys may be released in any order. 

Other standard control codes can be generated in the same way, 
with E through O generating 05H through 0FH and P through Z 
generating 10H through 1SH (you can test this by generating 08H 
shift ! ,H for a back space). 

If the default special codes are not appropriate, load TBUG LEVEL II 
via the SYSTEM command in BASIC (use the Reset push button) 
and enter the desired codes into 50B9 through 50BCH. Use TBUG 
to re-enter TERM by a jump to 5000H. Note that TERM is located 
at 5000H through 50BC so that it can be resident in RAM along 
with TBUG. 



HINTS and NOTES 

1 . Shorting pins 2 and 3 of the RS-232-C connector is a good way 
to test programs and hardware. 

2. In data communications, problems will readily occur if you 
have incorrectly set the even/odd parity, parity enable, baud 
rate, terminal/data set, (input/output correspondence with 
pins 2 and 3, etc.). 

3. The TERM program does not check for the various error 
status flags provided with the RS-232-C hardware such as 
parity error, overflow, etc. If you are a skilled programmer, 
you will be pleased to know it is possible to use TBUG to 
make use of this ignored information in various applications. 
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Program Listing of TERM 

The program listing for TERM has been modified (for cassette tape) 
to include the following "patch" which displays a vertical bar on 
the Display screen whenever any of the following serial input faults 
occur: 

1 . Parity fault 

2. Over-run (i.e. UART received another character before the 
previous one was read in by the TERM program) 

3. Framing (i.e. a spacing level was detected by the UART when 
the "stop bit" period should have been occurring) 

You can disable the "patch" by changing: 

at 5018, 5019, 501 A hex, replace C3 ,"(70, 50 with E6, 7F, FE as 
shown in the listing. 



The patch is: 

1. At 5018. 5019, 501A putC3,C0, 50 

2. At 50C0 hex insert: 



50C0 F5 
50C1 3A6650 
50C4 E6 38 
50C6 28 05 
50C8 3E AA 
50CA CD 33 00 
50CD F1 
50CE E6 7F 
50 D0 FE GO 
50D2 C3 1C 50 



PATCH PUSH AF 

LD A,(5066H) 

AND 38 

JR 7, NOFLT 

LD A.0AAH 

CALL DSP$ 
NOFLT POP AF 

AND 7FH 

CP GOH 

JP OUT-OF-PATCH 



GET UART STATUS 
FROM UCB 
OV, FE, PE? 

DISPLAY BAR 



Following is the complete listing of the TERM program. 



OOOO 1 






; CASSETTE PROGRAM 


10 BE 


SyS 


TEM 


LOADED INTO 


00002 






; LEVEL 


II TRS-80 WITH RS 


-23 


2-C 


INTERFACE UHICH 


00003 






; CAUSE 


s system to 


BEHAVE 


AS 


A 


CRT TERMINAL 


00005 






i PROG 


By RKUBALA, 


REV IS 


ION 


THUR. 20 .JULi 1978. 


00007 




0033 


DSP* 


EQU 0033H 










OOOOS 




002 E 


KBDS 


EQU 002BH 










00009 




0046 


C 1 0* 


EQU 0046H 










0001 1 




5000 




ORG 5000H 










000 1 3 


5000 


3E 1 C- 


TERM 


LD A, 1CH 








i HOME CURSOR 


00014 


5002 


CD3300 




CALL DSP* 










000 1 5 


5005 


3E 1 F 




LD A, 1FH 








J CLEAR SCREEN 


000 1 6 


500 7 


CD3300 




CALL DSP* 










000 1 7 


500ft 


3E0E 




LD A, OEH 








; TURN CURSOR ON 


000 18 


500C 


CD3300 




CALL DSP* 










000 1 V 


500F 


CD5850 




CALL MRUART 










0002 1 






; MAIN 


PROGRAM - JUGGLES 


RS- 


Z'~-i'2. 


-C, KB. ?y. CRT. 
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Term Program Listing (Continued) 



00023 


5012 


CD4F50 


INS. 


CALL SIN 




00024 


5ol5 


B7 




OR A 




00025 


50 1 .;. 


2812 




JR Z, OUTS 




0002 c 


50 IS 


E67F 




AND 7FH 




0002 7 


501 A 


FE60 




CF' cOH 




00028 


50 1 C 


FA2 1 50 ; 




..IP M, * + 5 




00029 


50 IF 


E65F 




AND 5FH 




oOO 6u 


5o2 1 


FEoa 




LP OAH 




00031 


5023 


2SED 




■JR Z. INS 




00032 


5025 


CD3300 




CALL DSP* 




00033 


5o2S 


18ES 




•JR INS 




00035 


502A 


CD2B00 


OUTS 


CALL CUD* 




0003c* 


50 2D 


B7 




OR A 




0003 /' 


502E 


28E2 




■JR I, INS 




0OO38 


5o30 


FE05 




CP 05H 




OOOS":-' 


50 32 


F23D50 : 




..IP P, NOSPEC 




00040 


5035 


2 1 BS50 : 




LD HL, SPECTB-1 




0004 i 


5o3S 


4F 




LD C. A 




00042 


5039 


0600 




LD B, 




00043 


503B 


09 




ADD HL, BO 




00044 


503C 


7E 




LD A, (HL) 




00045 


503D 


FE1A 


NOSPEC 


CF' 1 AH 




00046 


50 3 F 


2SD1 




.JR Z, INS 




00047 


5o4 1 


CD4e-50 




CALL 30UT 




00048 


5044 


18CC 




OR I MS 




00050 






RS-2 


32-C DRIVER CALL S 


EQUENCE 


00052 


504o 


116150 : 


SOU T 


LD DE, SUCB 




0O053 


5049 


C'5 




PUSH BC 




00054 


504A 


Oo20 




LD B, 2 OH 




00055 


5040 


C34600 




JP CIO* 




00057 


50 4F 


1 It. 150 


SIN 


LD DE, SUCB 




00058 


5052 


C5 




PUSH BC 




00059 


5053 


*j<r-4<j 




LD B, 40H 




OoOC'O 


5055 


C34c-00 




JP CIO* 




oO' >c2 


5058 


1 1 e. 1 50 


MRU ART 


LD DE, SUCB 




0006-3 


505B 


C5 




PUSH BC 




OOOc-4 


505C 


Oc-80 




LD B. SOH 




0006.5 


505E 


C34600 




•JP CIO* 





SEE IF NEW MART INPUT 

IF NO I, LOOK AT KB 
STRIP PARITY FROM ASCII. 



CONV, LOWER TO UPPER CASE 

IGNORE "LF". 

DISPLAY DISPLAiABLE CHAR. ON CRT 



SPECIAL CODES TABLE 



; HL =1. SELECTED SPEC CODE 
, GET SPECIAL CODE 



IGNORE SHIFT DOWN-ARROW 
OUTPUT KB INPUT TO RS-232-C 



.OUTPUT ByTE. 



INPUT ByTE IF AMY 



; RESET UART. 



RS-232-C UNIT CONTROL BLOCK 



X'Oc.9 


50 c. 1 


EO : 


;UCB BYTE OEOH i 


x>07o 


50c. 2 


c-950 > 


WORD RS232 ; 


J0071 


50c4 


00 


BrTE 


J0072 


5065 


00 


ByTE 


X'iO 7 3 


506.6 


00 


B Y I E 


J00 7 4 


50c 7 


00 


ByTE 


0o075 


50C.S 


00 


BYTE 


J00 7 7 






RS-232-C DRIVER 


00078 








000 7 9 






ENTRy: IX =o UCB+O 


00080 






C = PARAMETER 


0008 1 






B = FCT CODE 


000£2 








00083 






EXIT: A = STATUS OR DATA 


00085 


5069 


78 


RS232 LD A, B 


0008c- 


50cA 


17 


RLA 


00087 


506B 


3821 


.JR C, I UART 


00088 


50oD 


17 


RLA 


00089 


506E 


3805 


■JR C, RSRD 


00090 


50 70 


1 7 


RLA 


00091 


507 1 


330E 


■JR C, RSWR 


00092 


5073 


AF 


RSX XOR A 


OOOV3 


5074 


C9 


RET 


00095 


5075 


DBEA 


RSRD IN A, (CTRL) 


00096 


5077 


DD7 7 05 


LD (IX+5>,A 


00097 


507A 


CB7F 


BIT 7, A 



FUNCI IONS MASK 
DRIVER ADDRESS 
TERM SWITCH CONFK 
BAUD RATE CODE 
UART STATUS 
MODEM STATUS 
CTRL REO IMAGE 



EXAMINE FCT POST 



REG 



GET UART ST ATI. 

IMAGE TO HOP 

IS RCVD BYTE AVAIL 
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0009 b 


507 C 


28F5 




JR Z.RSX 


00099 


50 7 E 


DBEB 




IN A. (DATA) 


00 1 00 


5080 


C9 




RET 


00102 


5081 


DBEA 


RSWR 


IN A. (CTRL) 


00 1 03 


5083 


DD7 705 




LD I IX+5), A 


00 1 04 


5086 


CB77 




BIT 6. A 


00105 


5088 


28F7 




■JR Z , RSWR 


00 1 0t- 


508M 


79 




LD A, C 


00107 


508B 


D3EB 




OUT (DATA). 


oo l oy 


5oaD 


L9 




RET 


00 1 1 




00E8 


MR 


EQU OESH 


00111 




O0E8 


MODEM 


EQU 0E8H 


00112 




00E9 


CONF 1 G 


EQU 0E9H 


00 1 1 3 




OOEm 


CTRL 


EQU OEaH 


00 1 1 4 




OOEB 


DATA 


EGU OEBH 



; IF NOT 

i GET DATUM 



DO NOT STRIP PARITY POSH 



GET UART STATUS REG CONTENTS 
IMAGE TO IICB. 

IS XMIT HOLDING REG EMPTY? 
IF NOT, WAIT 

i OUTPUT BrTE 



001 lo 



INITIALIZE RS-232-C HARDWARE USING CONFIG SWITCHES 



00 1 1 8 


508E 


D3E8 




00119 


5090 


DBE9 




00120 


5092 


DD7703 


00 1 2 1 


5095 


EfcFS 




00 1 22 


5097 


F605 




00123 


5099 


DD7 7(. 


7 


00124 


509C 


D3EA 




001 2 c- 


509E 


DBE9 




00127 


50A0 


E*07 




00 128 


50A2 


21B150 


00129 


50A5 


0600 




00 1 30 


50a 7 


4F 




00 1 3 1 


50aS 


09 




00 132 


50A9 


7E 




00 1 33 


50«h 


DD7 7< 


>4 


0O134 


50AD 


D3E9 




001 35 


50AF 


AF 




00 1 3c 


50B0 


C9 





I UART 



I BRG 



OUT ( MR ) , A 

IN A, (CONF IG) 

LD ( 1 x+3) , A 

AND 0F8H 

OR 05H 

LD ( I x+7 ) , A 

OUT (CTRL), A 

IN A. (CONFIG) 

AND 07 H 

LD HL. BAUDTB 

LD B, O 

LD C. A 

ADD HL , BC 

LD A, iHL) 

LD (IX + 4),A 

OUT (CONFIG), f 

xuR H 

RET 



RESET UART WITH ANY OUT DATA 

GEI TERM CONFIG SWITCHES STATE 

SAVE IMAGE. 

MASK OFF BAUD PATE INFO 

SET BRK, RESET DTP. SET PTS 

SAVE IMAGE OF CTRL REG 

AND PUT IN CTRL. REG 

:GET BAUD RATE SWITCH STATE 
i BAUD RATE BITS ONLY 



HL => BAUD PATE CODE 
GET BAUD RATE CODE. 
SAVE IMAGE IN MCB 
LOhCi BAUD RATE GEN 



BAUD RATE CODE TABLE 



00140 


50B1 


22 


BAUDTB 


Br TE 


22H 


00141 


50B2 


44 




Br IE 


44H 


00142 


5oB3 


55 




BrTE 


55H 


00143 


50B4 


66 




BrTE 


66H 


00144 


50B5 


7 ? 




BrTE 


77H 


00145 


50B6 


AA 




BrTE 


OAAH 


00 1 46 


SOB? 


CL 




BrTE 


OCCH 


00147 


SOBS 


EE 




BrTE 


OEEH 



1 1 BAUD 
150 BAUD 
300 BAUD 
c-00 BAUD 
1 200 
2400 
4800 
9,300 



0014'i 



TABLE OF SPECIAL CODES 



('0151 50B9 03 




SPECTE; BrTE 


03H 


00152 50BA IB 






Bi TE 


1BH 


00153 50BB 7C 






BYTE 


7CH 


00154 50BC 7F 






BrTE 


7FH 


SCALARS 










CIO* 0046 






CONFIG - 


00E9 


KBDt 002B 






MODEM — 


00E8 


>.T0 (DEFAULT) SEC 


T 1 ON 


( 50BD 






BAUDTB - 50B1 






1BRG 


509E 


NOSPEC - 503D 






OUTS 


502A 


RSX 5073 






SIN 


504F 


TERM 5000 











DEFAULT 
DEFAULT 
DEFAULT 
DEFAUL T 



EOT - CTRL "A" 
ESC - CMTRL"B" 
VERT BAP - CNTPI "C 
DEL - CTRL"D" 



■ALSO "ATTN" 



CTRL - 
MR 



OOEA 
00E8 



DATA 



'OEB 



INS — 


— 


5012 


RS232 


— 


506V 


S0U1 - 


— 


504 c 



I UART — 


5. 


•SE 


RSRD 


51 


IT'S 


SFECTB - 


CJ, 


■B> 



156 SOURCE LINES 



156 ASSEMBLED LINES 
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Example Applications Program for Line Printer 

A common application for the Radio Shack RS-232-C is the output 
of serial data to a line printer. 

Before continuing with the specifics of the software, an overview 
of the I/O driver organization of Level II BASIC is in order. 
Shortly after power on in Level 11 BASIC, a set of addresses relating 
to the I/O drivers is written into the lower part of RAM. These 
addresses direct the BASIC software to each of the I/O drivers 
as needed (i.e. LPRINT, PRINT, CLOAD, CSAVE, LIST, LLIST, 
etc.). 

These addresses remain in low memory as long as power is supplied 
to the computer or unless they are written over with new information. 
In general, these addresses are not written over in normal operation 
and are purposely located in an area of memory which is not 
disturbed by Level II BASIC. We can, however, purposely write 
over the addresses in order to direct BASIC to an I/O driver of our 
own design. The addresses noted above, along with other I/O 
specific information, are referred to as "device control blocks" or 
DCB's. The DCB for the Line Printer begins at memory address 
4025H and is organized as shown below. 

MEMORY ADDRESS MEMORY CONTENTS 

4025H DCB TYPE (Input, or output operation) 

4026H DRIVER ADDRESS (Low order Byte) 

4027H DRIVER ADDRESS (High order Byte) 

The line printer driver normally referred to by the DCB is located in 
the Level II ROMS and expects a Centronics parallel type interface 
to be utilized. If we purposely alter this DCB to point to an address 
in RAM and place our own I/O driver at this address, we can utilize 
the Level II commands which refer to the line printer (LPRINT, 
LLIST) with the serial line printer. 

For this example let's assume that we wish to interface a Level II 
TRS-80 to a serial line printer operating at 300 baud. The line 
printer expects a seven-bit word, one stop bit, and even parity. Let 
us also assume that the printer has one output line which can be 
tested to determine if the printer can accept data. When status line 
is low it means that the printer is not busy and can accept data from 
the Interface; when it is high, it means that the printer is busy and 
cannot accept data for the time being. 
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This status information from the printer can be tested by the 
TRS-80 CPU if we connect it to one of the four inputs available on 
the RS-232-C Interface (CTS. DSR, DC RI). A jumper wire from 
pin 6 of the printer connector (assuming the standard DB-25 is 
used on the printer) to the "status output" of the printer should be 
the only modification needed. 

The printer should now be ready to print if we can provide the 
proper software to interface with it. Before we can actually output 
data, the printer and the RS-232-C Interface must be properly 
initialized as to the baud rate, word length, parity convention and 
stop bits required by the printer. This is one of the tasks which 
must be taken care of by the driver software. The assembly language 
listing on pages 27 and 28 provides Software to drive a DECWRITER. 
Lines 1 80 through 440 of the listing comprise the initialization 
section of the driver routine. This section of code tests a flag in 
memory to see if the Interface has been initialized, and, if so, 
branches around the rest of the initialization section and goes 
directly to the actual output section of the code (lines 500 through 
620). The initialization occurs the first time the driver program is 

called by BASIC and a flag is set indicating this fact. This section 

of code is bypassed on successive calls to the driver routine. 

Assembly Language DECWRITER Driver Program 



88E8 
88E9 

80EB 
7F88 



7F80 E5 
7F81 C5 
7F82 F5 



7F83 3A487F 
7F86 FE81 
7F88 2828 
7F8A 3E81 
7F8C 32487F 
7F8F D3E8 
7F11 DBE9 
7F13 E6F8 
7F15 F684 
7F17 32477F 
7Fifl D3EA 
7F1C DBE9 
7F1E E687 
7F28 213F7F 
7F23 8668 



88180 RESURT EQU 8E8H ; AN OUT TO THIS L0C RESETS THE UART, AN IN RERDS THE RS232 CONTROL BITS 

88118 SWITCH EQU 8E9H ; RN OUT TO THIS L0C LORDS THE BRUD RATE GENERATOR, RN IN RERDS THE SENSE SWITCHES 

88128 CNTREG EQU 8ERH ; RN OUT TO THIS LOC LORDS THE URRT CONTROL REGISTER, RN IN RERDS THE URRT STATUS REG. 

88138 DTAREG EQU 8EBH ; RN OUT TO THIS LX LORDS TH URRT XMIT HOLDING REG. , RN IN READS THE RECEIVED DATA 

88148 ORG 7F88H ; 32512D ORG FOR DRIVER 

88158 ; RS232C OUTPUT DRIVER TO BE USED WITH THE LPR1NT COMMAND IN LEVEL II BRSIC. 

88168 , THE DRIVER IS POKED INTO HIGH MEMORY (16K MACHINE) AND THE DEVICE CONTROL BLOCK 

88178 ; CHANGED TO VECTOR THE LPR1NT COMMAND TO THE RS232C DRIVER WITH A SHORT BASIC PROGRAM. 

88188 IN1T PUSH HL ; SAVE REG. USED 



88198 

88208 

88218 

80228 

80238 

80248 

80258 

88268 

00278 

08280 

08298 

88380 

88310 

00328 

88330 

88340 BRUDST 

00358 

08368 

08378 



PUSH BC 

PUSH RF 
THIS SECTION OF CODE IS USED TO INITIALIZE THE RS232C INTERFACE TO CORRESPOND TO 
THE OPTIONS SPECIFIED BV THE SENSE SWITCHES IN THE INTERFACE (BAUD RATE, STOP BITS, BITS/CHAR. ETC. ) 



LD A, (FLAG) 

CP 01H 

JR 2, RESTOR 

LD A, 01H 

LD (FLAG), A 

OUT (RESURT), A 

IN A, (SWITCH) 

RND 8F8H 

OR 84H 

LD (SWT1MG),R 

OUT (CNTREG), R 

IN R, (SWITCH) 

RND 87H 

LD H,BDTRBL 

LD B,88H 



CHECK FLAG TO SEE IF URRT AND BRG HRVE BEEN INIT. 

RESTORE REG. AND OUTPUT CHRR IF SO 

SET FLAG TO INICRTE INIT. 

RERD 37DCH TO RESET URRT 

READ SENSE SWITHES 

LOP OFF LOWER 3 BITS 

RESETS RTS, RESETS DTR,SETS BRK IN HANDSHAKE LATCH 

LOAD SWTIMG W/1MAGE OF LATCH BITS 

LORD URRT W/SWITCH IMRGE 

SET BAUD RATE ACCORDING TO SWITCH SELECTION 

LOP OFF UPPER 5 BITS 

POINT TO FIRST LOC IN BRUD TBL 

ZERO B REG 
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7F25 4F 88386 LD Cfi ; PUT OFFSET IN C 

7F26 89 88398 HDD HLBC ; ADO OFFSET TO HL 

7F27 7E 88488 LD fc <HL> ; LORD POINTED VALUE 

7F28 D3E9 88418 OUT (SWITCH), fl ; LORD BRG W/TABLE VALUE 

7F2A Fl 88428 RESTOR POP AF 

7F2B CI 88438 POP BC 

7F2C Ei 88448 POP HL ; RESTORE REG 

86456 , THIS SECTION OF CODE DOES THE ACTUAL OUTPUT OF THE CHAR. TO THE UART FOR SERIAL XHIT. 

86452 ; IT FIRST CHECKS THE UfiRT TO SEE IF IT'S HOLDING REGISTER IS EHPTV, LOOPS UNTIL IT IS 

86453 ; ft* LOADS THE CHARACTER TO BE TRANSMITTED TO THE HOLDING REGISTER. IF THE CHAR HAS A CARRIAGE 
88454 ; RETURN A LINE FEED IS ALSO OUTPUT. 

7F2D DBEA 86498 STATIN IN fl, (CNTREG) ; LOAD UfiRT STATUS 

7F2F CB77 88588 BIT 6, A ; TEST THRE FOR HIGH 

7F31 28FA 88518 JR Z, STATIN ; LOOP IF NOT 

7F33 79 88528 LD A,C ; LOAD A HrtHAR TO BE OUTPUT 

7F34 D3EB 68538 OUT (DTAREG),A ; LOAD HOLDING REG H/CHAR 

7F36 FE8D 68548 CP 8DH ; IS IT A CARRIAGE RET ? 

7F38 2864 88556 JR NZ,RETRN ; RETURN IF NOT 

7F3R 6E6A 88568 LD C8AH ; IF SO OUTPUT A LINE FEED ALSO 

7F3C 18EF 88578 JR STATIN ; OUTPUT TO UART 

7F3E C9 88588 RETRN RET ; RETURN TO CALLING CODE 

68598 ; THE FOLLOWING TABLE DEFINES THE BAUD RATE SELECTED BV THE SENSE SNITCHES IN THE INTERFACE 

7F3F 22 88668 BDTABL DEFB 22H i 116 BAUD 

7F46 44 86618 DEFB 44H ; 158 BAUD 

7F41 55 88628 DEFB 55H ; 388 BAUD 

7F42 66 88638 DEFB 66H ; 688 BAUD 

7F43 77 88648 DEFB 77H ; 1288 BAUD 

7F44 AA 88658 DEFB 8AAH > 2488 BAUD 

7F45 CC 88668 DEFB 8CCH ; 4886 BAUD 

7F46 EE 88678 DEFB BEEH ; 9688 BAUD 

7F47 86 86688 SHT1MG DEFB 86H ; IMAGE OF HANDSHAKE LATCH 

7F48 66 86698 FLAG DEFB 86H ; FLAG TO INDICATE INITIALIZATION 

8886 86788 END 
88888 TOTAL ERRORS 
RETRN 7F3E 
STATIN 7F2D 
BDTABL 7F3F 
BAUDST 7F1C 
SHTIMG 7F47 
RESTOR 7F2A 
FLAG 7F48 
INIT 7F88 
DTAREG 86EB 
CNTREG 88EA 
SWITCH 68E9 
RESURT 86E8 
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RND RDDRESS 


IN RON C4025H} + 


i : POKE 16423, 


127 


DRIVER INTO 


HIGH MEM <7F00H> 



BASIC Program for DECWRITER 

10 REM ** POKE HEN DCB TYPE 

20 POKE 16421, 2 : POKE 16422, 

20 REM +* POKE RS--232-C I/O 

40 FOR X=32512 TO 32584 

50 RERD V 

60 POKE X, V 

70 NEXT X 

75 END 

8@ DRTR 229, 137, 245, 58, 72, 127, 254, 1, 40 

90 DRTR 32, 62, 1, 50, 72, 127, 211, 232, 219, 233 

100 DRTR 230, 248, 246, 4, 50, 71, 127, 211, 234 

110 DRTR 219, 233, 230, 7, 33, 63, 127, 6, 0, 79, 9 

120 DRTR 126, 211, 233, 241, 193, 225, 219, 234 

130 DRTR 203, 119, 40, 250, 121, 211, 235, 254 

140 DRTR 13, 32, 4, 14, 10, 24, 239, 201, 34, 68 

150 DRTR 85, 102, 119, 170, 204, 238, 0, 

The initialization code must reset the UART, read the configuration 
sense switches, load the UART with the control information 
specified by the switches (stop bits, word length, and parity 
convention), load the BRG with the correct code for the baud rate 
specified by the switches, and set the initialization flag in memory. 

Lines 500 through 620 accomplish the actual output of data to the 
printer. The software first checks to see if Data Set Ready is low 
and loop-tests each time if not. When found low, it checks the 
UART's transmitter holding register status-bit for a high 
(indicating the UART can accept a new character for transmission), 
loops if not, or loads the UART holding register with the next 
character if so. The character just loaded is then tested to see if it 
was a carriage return (0DH) and if so, a line feed (0AH) is 
transmitted also. This line feed may or may not be necessary 
depending upon the specific printer being interfaced. (This part of 
the code can be deleted if desired.) Control is now transferred 
back to BASIC. 

Following the assembly language driver on page 28 is a BASIC 
program listing. This BASIC program accomplishes two tasks, 
writing a new address in the line printer DCB (line 20) and writing 
the actual printer driver code into high memory (lines 40 through 
1 20). Lines 80 through 1 50 are data statements which contain 
the decimal equivalents of each byte of the driver object code shown 
in the second column of the assembly language listing on pages 

27 and 28. 

To use this program, see page 30. 
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Assuming the specific interface requirements are identical to this 
example, now all you do is type in the BASIC program listed on 
page 28, run it and now you are ready to use a serial line printer 
with BASIC. A step-by-step illustration of this procedure is shown 
below. 

1 . Power up TRS-80 and Expansion Interface. 
MEMORY SIZE? 

should be displayed on the Video Monitor. 
You should respond with: 

32511 

and press I3'ii3;l (Decimal equivalent of 7EFFH). 
This response reserves the top 256 bytes of a 16K TRS-80 
for the printer driver. 

2. Set configuration switches for desired baud rate, stop bits, 
word length and parity as required. See esample on page x. 

3. Type in the BASIC program listed on page xx with appro- 
priate modifications for specific application or load from 
cassette a previously saved version of the above. 

4. Run the BASIC program. 

5. Connect the Line Printer to the RS-232-C with the cable 
provided (or an appropriately modified cable). 

6. Now you can use a serial line printer with the Level II 
BASIC LPRINT and LLIST commands. 

Any BASIC programs which utilize this technique must include the 
BASIC program on page 29 as a part of the coding and this section of 
code must be executed prior to using the serial line printer. If you 
do not want to locate the object code for the line printer driver at 
7F00H (as in this example), you can reassemble the source code on 
page 27 with a different origin (line 140) using the TRS-80 Editor 
Assembler and modify the BASIC program to correspond to this new 
location. The response to the memory size question must also be 
modified to be the decimal equivalent of one byte less than the 
beginning address of the line printer driver object code. The data 
statements in the BASIC program on page xx must be altered to 
reflect any change in the object code due to relocation or modifica- 
tion. The last two poke statements on line 20 on page 28 must be 
changed to correspond to the decimal equivalent of the new beginning 
address of the driver object code (argument of second poke statement 
is the low-order byte of the new address, and the argument of the 
third poke statement is the high-order byte of the new address). 
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P/O TRS-80 EXPANSION INTER- 
FACE CARD EDGE CONNECTOR 



P/O RS-232-C 25 PIN 
SERIAL CONNECTOR 
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FIGURE 6. RS-232-C CABLE (40-CONDUCTOR TO 25-PIN CONNECTOR) 
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LIMITED WARRANTY 

Radio Shack warrants for a period of 90 days from the date of delivery 
to customer that the computer hardware described herein shall be free 
from defects in material and workmanship under normal use and service. 
This warranty shall be void if this unit's case or cabinet is opened or if 
the unit is altered or modified. During this period, if a defect should 
occur, the product must be returned to a Radio Shack store or dealer 
for repair. Customer's sole and exclusive remedy in the event of defect 
is expressly limited to the correction of the defect by adjustment, re- 
pair or replacement at Radio Shack's election and sole expense, except 
there shall be no obligation to replace or repair items which by their 
nature are expendable. No representation or other affirmation of fact, 
including but not limited to statements regarding capacity, suitability 
for use, or performance of the equipment, shall be or be deemed to be a 
warranty or representation by Radio Shack, for any purpose, nor give 
rise to any liability or obligation of Radio Shack whatsoever. 



EXCEPT AS SPECIFICALLY PROVIDED IN THIS AGREEMENT, 
THERE ARE NO OTHER WARRANTIES, EXPRESS OR IMPLIED, 
INCLUDING, BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES 
OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PUR- 
POSE AND IN NO EVENT SHALL RADIO SHACK BE LIABLE FOR 
LOSS OF PROFITS OR BENEFITS, INDIRECT, SPECIAL, CONSE- 
QUENTIAL OR OTHER SIMILAR DAMAGES ARISING OUT OF 
ANY BREACH OF THIS WARRANTY OR OTHERWISE. 
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